home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / dev / misc / ahidev.readme < prev    next >
Encoding:
Text File  |  1997-05-03  |  12.9 KB  |  291 lines
  1. Short:    Retargetable audio v4, Developer's Archive
  2. Author:   Martin Blom <lcs@lysator.liu.se>
  3. Uploader: Martin Blom <lcs@lysator.liu.se>
  4. Type:     dev/misc
  5. Replaces: dev/misc/ahi.lha
  6.  
  7. TITLE
  8.  
  9.      AHI Audio System
  10.  
  11. VERSION
  12.  
  13.      Release 4
  14.  
  15. AUTHOR
  16.  
  17.      Martin Blom <lcs@lysator.liu.se>
  18.  
  19. DESCRIPTION
  20.  
  21.      Retargetable Audio for AmigaOS
  22.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  23.  
  24.      (When refering to this software, the correct term is
  25.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  26.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  27.  
  28.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  29.      However, many features are lacking:
  30.  
  31.      · 16 bit samples are converted to 8 bits before they are mixed.
  32.      · No HiFi mixing routines are available.
  33.      · No stereo samples
  34.      · No DSP effects are available.
  35.      · Less precision on some calculations
  36.      · Slower
  37.  
  38.      As you can see, this version is very primitive.  Get yourself an
  39.      accelerator!  I cannot guarantee that I will continue to support this
  40.      processor in the future.
  41.  
  42.      Quick overview
  43.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  44.  
  45.      * Driver based
  46.  
  47.      Each supported sound card is controlled by a library-based audio
  48.      driver. For a 'dumb' sound card, a new driver should be written in
  49.      a few hours. For a 'smart' sound card, it is possible to utilize an
  50.      on-board DSP, for example, to maximize performance and sound quality.
  51.      For sound cards with own DSP but little or no memory, it is possible
  52.      to use the main CPU to mix channels and do the post-processing
  53.      with the DSP. Available today are drivers for
  54.  
  55.      · Aura (sampler only)
  56.      · Delfina
  57.      · DraCo Motion
  58.      · Paula (8/14/14c bit)
  59.      · Prelude
  60.      · Toccata
  61.      · Wavetools
  62.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  63.  
  64.      * Fast, powerful mixing routines (yeah, right... haha)
  65.  
  66.      The device's mixing routines mix 8- or 16-bit signed samples, both
  67.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  68.      (with stereo panning if desired) data, using any number of channels
  69.      (as long as 'any' means less than 128...).  Tables can be used speed
  70.      the mixing up (especially when using 8-bit samples).  The samples can
  71.      have any length (including odd) and can have any number of loops.
  72.      
  73.      * Support for non-realtime mixing
  74.  
  75.      By providing a timing feature, it is possible to create high-
  76.      quality output even if the processing power is lacking, by saving
  77.      the output to disk, for example as an IFF AIFF or 8SXV file.
  78.      There are so-called HiFi mixing routines that can be used, which
  79.      use linear interpolation and gives 32 bit output.
  80.  
  81.      * Audio database
  82.  
  83.      Uses ID codes, much like Screenmode IDs, to select the many
  84.      parameters that can be set. The functions to access the audio
  85.      database are not too different from those in 'graphics.library'.
  86.      The device also features a requester to get an ID code from the
  87.      user.
  88.  
  89.      * Both high- and low-level protocol
  90.  
  91.      By acting both like a device and a library, AHI gives the programmer
  92.      a choice between full control and simplicity. The device API allows
  93.      several programs to use the audio hardware at the same time, and
  94.      the AUDIO: dos-device driver makes playing and recording sound very
  95.      simple for both the programmer and user.
  96.  
  97.      * Future Compatible
  98.  
  99.      When AmigaOS gets device-independent audio worth it's name, it should
  100.      not be too difficult to write a driver for AHI, allowing applications
  101.      using 'ahi.device' to automatically use the new OS interface. At
  102.      least I hope it wont.
  103.  
  104. SPECIAL REQUIREMENTS
  105.  
  106.      AmigaOS release 2.
  107.      MC68020 processor strongly recommended.
  108.  
  109. AVAILABILITY
  110.  
  111.      Aminet, for example:
  112.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  113.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  114.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  115.  
  116.      WWW:
  117.      http://www.lysator.liu.se/~lcs/ahi.html
  118.  
  119. PRICE
  120.  
  121.      Free. But if you use it in a shareware of commercial product,
  122.      I would like a registered copy for me and each of the audio driver
  123.      authors (this is merely a wish, you don't have to do it if you don't
  124.      think we deserve it). See the AHI User's Guide for more information.
  125.  
  126. DISTRIBUTABILITY
  127.  
  128.      Copyright ©1994-1997 Martin Blom.
  129.      Freely distributable in unmodified form.
  130.      See the AHI User's Guide for more information.
  131.  
  132.  
  133. ============================= Archive contents =============================
  134.  
  135. Original  Packed Ratio    Date     Time    Name
  136. -------- ------- ----- --------- --------  -------------
  137.      632     283 55.2% 20-Apr-97 18:13:06  AHI.info
  138.    35250    7875 77.6% 18-Apr-97 18:29:56 +AHI Install
  139.      709     363 48.8% 15-Apr-97 19:28:26 +AHI Install.info
  140.     4485    2115 52.8% 23-Apr-97 09:15:18 +ahidev.readme
  141.      468     229 51.0% 15-Apr-97 19:28:26 +ahidev.readme.info
  142.      364     219 39.8% 21-Mar-97 20:13:22 +Copyright
  143.      468     233 50.2% 15-Apr-97 19:28:26 +Copyright.info
  144.    64775   17798 72.5% 21-Apr-97 23:41:44 +ahi.doc
  145.    75406   19047 74.7% 21-Apr-97 23:41:46 +ahi.guide
  146.    79269   19266 75.6% 21-Apr-97 23:41:50 +ahi.html
  147.    22696    6761 70.2% 21-Apr-97 23:41:52 +ahi_sub.doc
  148.    26623    7382 72.2% 21-Apr-97 23:41:52 +ahi_sub.guide
  149.    27580    7446 73.0% 21-Apr-97 23:41:54 +ahi_sub.html
  150.    49147   14362 70.7% 21-Apr-97 23:42:20 +devguide.guide
  151.     1373     437 68.1% 17-Sep-96 11:08:26 +asmfuncs.a
  152.    22915    5852 74.4% 16-Apr-97 17:15:32 +filesave.c
  153.     2432     966 60.2% 08-Sep-96 14:26:28 +filesave.h
  154.      594     279 53.0% 08-Sep-96 14:26:42 +filesave.i
  155.     2049     418 79.5% 28-Sep-96 11:58:28 +prefsfile.a
  156.     1488     599 59.7% 16-Apr-97 17:22:50 +smakefile
  157.      666     319 52.1% 18-Nov-96 23:53:30 +macros.i
  158.    64520   18314 71.6% 17-Apr-97 01:05:20 +paula_audio.a
  159.     4805     541 88.7% 21-Feb-97 00:23:42 +prefsfile.a
  160.      490     213 56.5% 24-Nov-96 21:59:30 +smakefile
  161.     7613    2064 72.8% 04-Apr-97 19:03:30 +asmfuncs.a
  162.     2104     372 82.3% 20-Feb-97 10:02:32 +prefsfile.a
  163.     1345     603 55.1% 20-Apr-97 12:49:44 +smakefile
  164.    17797    4704 73.5% 20-Apr-97 13:26:00 +toccata.c
  165.     1066     423 60.3% 08-Apr-97 23:09:02 +toccata.h
  166.      665     309 53.5% 04-Apr-97 17:55:22 +toccata.i
  167.     5794    2372 59.0% 23-Dec-95 12:19:54 +dad_audio.i
  168.     1045     593 43.2% 15-Feb-97 01:27:24 +log.ascii
  169.      112      89 20.5% 19-Feb-97 10:18:38 +makeit
  170.     2184     420 80.7% 20-Feb-97 10:05:32 +PrefsFile.s
  171.      693     403 41.8% 15-Feb-97 01:29:44 +wavetools.audio.readme
  172.    26518    6899 73.9% 15-Feb-97 01:32:22 +wavetools_audio.s
  173.      987     506 48.7% 09-Apr-97 01:54:16 +AHI-Handler.DICE
  174.       53      53  0.0% 09-Apr-97 01:54:26 +clean
  175.    30792    7674 75.0% 09-Apr-97 01:55:50 +main.c
  176.     3960    1248 68.4% 12-Mar-97 16:28:54 +main.h
  177.    60110   15947 73.4% 09-Apr-97 01:55:50 +main.c,v
  178.     2916    1945 33.2% 22-Apr-97 00:13:26 +PlayTest
  179.     3579    1451 59.4% 08-Apr-97 23:34:36 +PlayTest.c
  180.      138     119 13.7% 26-Mar-97 02:07:36 +SCOPTIONS
  181.      261     189 27.5% 02-Apr-97 21:47:20 +smakefile
  182.     2736    1833 33.0% 22-Apr-97 00:13:20 +RecordTest
  183.     2724    1136 58.2% 08-Apr-97 23:34:26 +RecordTest.c
  184.      138     119 13.7% 03-Nov-96 19:22:44 +SCOPTIONS
  185.      275     192 30.1% 02-Apr-97 21:48:26 +smakefile
  186.     1226     580 52.6% 02-Apr-97 21:48:46 +AHI_lib.c
  187.     2382    1044 56.1% 01-May-96 20:13:30 +GetAudioID.info
  188.      840     474 43.5% 01-May-96 20:13:30 +empty.ct
  189.      376     232 38.2% 01-May-96 20:13:30 +GetAudioID.catalog
  190.     2276    1394 38.7% 01-May-96 20:13:30 +GetAudioID
  191.     8438    3543 58.0% 01-May-96 20:13:30 +GetAudioID.guide
  192.     1831    1130 38.2% 01-May-96 20:13:30 +GetAudioID.guide.info
  193.     1903     600 68.4% 01-May-96 20:13:30 +GetAudioID.info
  194.      841     463 44.9% 01-May-96 20:13:30 +GAI.cd
  195.    11973    4497 62.4% 01-May-96 20:13:30 +GAI.S
  196.    12600    6910 45.1% 02-Apr-97 21:50:34 +AHI-NotePlayer
  197.      657     333 49.3% 20-Apr-97 17:07:36 +AHI-NotePlayer.readme
  198.     3595     843 76.5% 02-Apr-97 21:50:34 +AHIDeliNPbase.ct
  199.     1014     590 41.8% 20-Apr-97 17:02:38 +AHIDeliNPbase.catalog
  200.     1894     633 66.5% 02-Apr-97 22:02:50 +BestAudioID_test.c
  201.     3528    2187 38.0% 22-Apr-97 00:13:16 +DoubleBuffer
  202.     7604    2069 72.7% 02-Apr-97 21:52:08 +DoubleBuffer.c
  203.      153     121 20.9% 30-Sep-96 09:38:30 +SCOPTIONS
  204.      289     181 37.3% 02-Apr-97 21:52:38 +smakefile
  205.    13035    3406 73.8% 16-Sep-96 15:51:34 +GUI.c
  206.    16250    2348 85.5% 18-Jul-96 09:17:18 +GUI.des
  207.      292      91 68.8% 18-Jul-96 09:17:18 +GUI.extras.h
  208.     2546     737 71.0% 16-Sep-96 15:51:36 +GUI.h
  209.    12676    6911 45.4% 21-Apr-97 23:40:28 +HardDiskRecord
  210.    19955    5951 70.1% 23-Jan-97 18:59:54 +HardDiskRecord.c
  211.     2612     616 76.4% 16-Sep-96 15:51:34 +HardDiskRecord.cd
  212.     2896     659 77.2% 16-Sep-96 15:51:34 +HardDiskRecord.ct
  213.     1657     679 59.0% 18-Jul-96 09:17:18 +HardDiskRecord.h
  214.      450     177 60.6% 22-Apr-97 00:01:02 +HardDiskRecord.info
  215.      374     246 34.2% 22-Apr-97 00:04:08 +HardDiskRecord.readme
  216.      463     218 52.9% 22-Apr-97 00:01:02 +HardDiskRecord.readme.info
  217.     3307    1191 63.9% 18-Jul-96 09:17:18 +recordfunc.a
  218.      671     355 47.0% 21-Apr-97 23:57:48 +smakefile
  219.     2318     761 67.1% 17-Apr-97 01:56:22 +PT-AHIPlay.h
  220.     1901     708 62.7% 17-Apr-97 01:56:26 +PT-AHIPlay.i
  221.     4508    2569 43.0% 21-Apr-97 23:39:44 +PT-AHIPlay.o
  222.    29971    7588 74.6% 17-Apr-97 10:44:00 +PT-AHIPlay.s
  223.    29117    7798 73.2% 17-Apr-97 01:26:54 +PT-AHIPlay_old.s
  224.       79      76  3.7% 17-Apr-97 10:43:14 +smakefile
  225.     6964    2036 70.7% 18-Apr-97 18:02:40 +Class.c
  226.     3038    1044 65.6% 18-Apr-97 17:38:54 +Data.h
  227.      485     268 44.7% 28-Oct-96 21:54:00 +DT_code.a
  228.      287     149 48.0% 20-Apr-97 16:50:34 +DT_ident
  229.     7179    2160 69.9% 18-Apr-97 17:39:16 +LibCode.c
  230.      263     151 42.5% 18-Apr-97 17:55:46 +protracker.datatype_rev.h
  231.      312     178 42.9% 18-Apr-97 17:55:46 +protracker.datatype_rev.i
  232.       15      15  0.0% 18-Apr-97 17:55:46 +protracker.datatype_rev.rev
  233.      281     168 40.2% 07-Oct-96 19:17:14 +protracker_rev.i
  234.       14      14  0.0% 07-Oct-96 19:17:14 +protracker_rev.rev
  235.     7000    4045 42.2% 21-Apr-97 23:40:00 +protracker.datatype
  236.      246     196 20.3% 21-Apr-97 23:40:06 +Protracker
  237.      473     294 37.8% 13-Oct-96 09:16:24 +Protracker.info
  238.       12      12  0.0% 13-Oct-96 09:16:24 +Protracker
  239.     1098     597 45.6% 20-Apr-97 16:46:26 +ProtrackerDT.readme
  240.     1338     529 60.4% 18-Apr-97 12:31:26 +RomTag.a
  241.     1091     578 47.0% 20-Apr-97 16:50:18 +SMakefile
  242.     2635    1234 53.1% 17-Nov-96 16:05:12 +RecordTestQnD.s
  243.     2280    1544 32.2% 22-Apr-97 00:13:14 +req-test
  244.     1915     855 55.3% 02-Apr-97 21:58:28 +req-test.c
  245.      150     116 22.6% 02-Apr-97 21:59:08 +SCOPTIONS
  246.      261     175 32.9% 02-Apr-97 21:59:40 +smakefile
  247.      153     121 20.9% 26-Jan-97 22:52:12 +SCOPTIONS
  248.     3344    2211 33.8% 22-Apr-97 00:13:18 +SimplePlay
  249.     8914    2424 72.8% 02-Apr-97 22:00:46 +SimplePlay.c
  250.      273     187 31.5% 27-Jan-97 01:36:06 +smakefile
  251.     4914     993 79.7% 21-Apr-97 23:41:26 +ahi.h
  252.     3115     696 77.6% 21-Apr-97 23:41:28 +ahi_sub.h
  253.       53      53  0.0% 15-Nov-96 00:23:00 +ahi_pragmas.h
  254.       61      61  0.0% 15-Nov-96 00:23:12 +ahi_sub_pragmas.h
  255.      188     135 28.1% 11-Jan-97 20:26:18 +ahi.h
  256.      205     144 29.7% 11-Jan-97 20:26:28 +ahi_sub.h
  257.    14140    4540 67.8% 09-Apr-97 01:31:36 +ahi.i
  258.     2661    1103 58.5% 02-Apr-97 22:03:52 +ahi_sub.i
  259.      850     287 66.2% 21-Apr-97 23:41:22 +ahi_lib.i
  260.      628     226 64.0% 21-Apr-97 23:41:22 +ahi_sub_lib.i
  261.     2011     632 68.5% 02-Apr-97 22:06:16 +ahi_protos.h
  262.     1424     503 64.6% 02-Apr-97 22:06:06 +ahi_sub_protos.h
  263.    14167    4160 70.6% 09-Apr-97 01:39:26 +ahi.h
  264.     3495    1249 64.2% 02-Apr-97 22:05:24 +ahi_sub.h
  265.      396     213 46.2% 21-Apr-97 23:41:28 +ahi.m
  266.      300     159 47.0% 21-Apr-97 23:41:30 +ahi_sub.m
  267.     4678    1923 58.8% 21-Apr-97 23:41:34 +ahi.m
  268.      822     425 48.2% 21-Apr-97 23:41:38 +ahi_sub.m
  269.      991     432 56.4% 02-Apr-97 22:06:42 +ahi_lib.fd
  270.      796     313 60.6% 26-Mar-97 23:25:16 +ahi_sub_lib.fd
  271.     1820     535 70.6% 21-Apr-97 23:41:24 +ahi_pragmas.h
  272.     1097     348 68.2% 21-Apr-97 23:41:26 +ahi_sub_pragmas.h
  273.      171     122 28.6% 21-Apr-97 23:41:26 +ahi.h
  274.      190     131 31.0% 21-Apr-97 23:41:26 +ahi_sub.h
  275.     1809     521 71.1% 21-Apr-97 23:41:22 +ahi_lib.h
  276.     1107     344 68.9% 21-Apr-97 23:41:24 +ahi_sub_lib.h
  277.      166     121 27.1% 21-Apr-97 23:41:24 +ahi.h
  278.      185     130 29.7% 21-Apr-97 23:41:24 +ahi_sub.h
  279.       50      48  4.0% 03-Mar-96 17:41:04 +ReadMe.txt
  280.     4696    2857 39.1% 03-Feb-97 01:33:00 +ScanAudioModes
  281.     8456    4950 41.4% 31-Dec-95 17:15:38 +sift
  282.     5765    1912 66.8% 21-May-96 19:19:16 +ScanAudioModes.c
  283.       96      76 20.8% 25-Nov-96 16:29:20 +SCOPTIONS
  284.      265     172 35.0% 21-May-96 19:19:30 +smakefile
  285.     5612    2503 55.3% 31-Dec-95 17:15:38 +sift.c
  286.    16286    6136 62.3% 22-Apr-97 01:16:12 +History
  287.      468     233 50.2% 15-Apr-97 19:28:26 +History.info
  288.       21      21  0.0% 23-Apr-97 09:19:10 +Version
  289. -------- ------- ----- --------- --------
  290.  1027483  314597 69.3% 23-Apr-97 17:38:34   152 files
  291.